home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / hisoft / doc2rtf.lha / DOC2RTF.text < prev    next >
Text File  |  1996-05-20  |  6KB  |  122 lines
  1. DOC2RTF 1.014
  2.  
  3. Documentation by Simon N Goodwin, May 1996.
  4.  
  5.  
  6. USAGE
  7.  
  8. This utility converts files written in Psion Quill word-processor format into
  9. the 'Rich Text' format used on many other platorms. It is based on SuperBASIC
  10. by Mark J Swift, originally written to support the Amiga Qdos emulator, which
  11. includes Psion XCHANGE, the full version of Psion's integrated business suite
  12. for the Qdos operating system.
  13.  
  14. The program runs from Workbench or CLI. If run from Workbench it uses the ASL
  15. requester to select input and output files.  This became part of the standard 
  16. Amiga system from Workbench 2 onwards,  but is only available as an extension
  17. for older versions of Workbench. DOC2RTF has only been tested from the CLI on
  18. Workbench 1.3. The CLI format is:
  19.  
  20.             DOC2RTF InFile OutFile
  21.  
  22. when the program reads InFile (which must be a Quill DOC) and writes OutFile.
  23. If another error occurs, a HiSoft BASIC requester pops up and DOC2RTF aborts.
  24.  
  25. Users may optionally specify the word TO between the InFile and OutFile name.
  26. If the OutFile name is not specified, DOC2RTF appends .RTF to the InFile name
  27. and creates an output file with that name.
  28.  
  29. If the input file is not in a valid DOC format, DOC2RTF prints an appropriate
  30. message. If the front-end is being used you get another chance to pick a file
  31. but if using the shell DOC2RTF terminates after displaying the error message.
  32.  
  33.  
  34. WHAT IS RICH TEXT FORMAT?
  35.  
  36. Rich Text is a way of encoding documents using standard ASCII character codes
  37. with ancillary formatting information added so the exact appearance on a page
  38. is preserved  even when the text is moved from one package - or computer - to
  39. another. Rich Text is extensively used on Apple Macintosh systems and is also
  40. recognised by workstations, Amiga Wordworth 5 and many PC programs, including
  41. Microsoft Works and Word for Windows.
  42.  
  43. Since Rich Text only uses the standard 7-bit ASCII character set, stripped of
  44. control codes apart from line-ends, it can be EMAILed without any requirement
  45. for the document to be UUENCODEd first.
  46.  
  47.  
  48. WHAT IS PSION QUILL?
  49.                                         
  50. Psion is the UK-based computer company responsible for the Organiser portable
  51. computers.  In the mid 1980s Psion wrote a suite of business programs (Quill,
  52. Archive,  Abacus  and  Easel) which was available on many platforms. The four
  53. programs were originally bundled with the  Sinclair QL, the first 68000-based
  54. multi-tasking  home computer  (introduced about a year before the Amiga)  and
  55. later as 'PC Four' for MSDOS machines.  Later all four programs were combined
  56. into one integrated package,  XCHANGE,  built into the ICL/BT  'One Per Desk'
  57. computer, and bundled with the  CST Thor,  a QL-clone produced in England and
  58. Denmark. XCHANGE was also converted to run on MSDOS PC-compatible systems.
  59.  
  60. The Psion suite  uses its own  proprietary format  for data files, as well as
  61. unformatted ASCII text files for 'import and export'.  The DOC file format is
  62. used by Quill, and it contains formatting information such as margins,  tabs,
  63. pagination  and text  attributes as well as the text itself.  It is useful to
  64. be able to convert DOC files into  Rich Text  because the formatting and page
  65. layout is preserved.  This would not be the case if an ASCII file was printed
  66. out or exported.
  67.  
  68. The Psion suite was exceptionally powerful in its day, and is still unusually
  69. well-integrated and easy to use.  Its main limitation  - compared with modern
  70. packages -  is that it does not support proportionally-spaced characters,  so
  71. it is not capable of Desktop Publishing effects.  But it's still very usable,
  72. especially if you wish to run an  integrated package on a floppy-based Amiga.
  73. The original package had to run in just 128K RAM,  loading and saving on 100K
  74. Sinclair Microdrive tapes,  so it runs quite comfortably on almost any Amiga.
  75.  
  76. The Quill word processor does not run under Amigados,  but it works very well
  77. under the freely distributable Amiga Qdos emulator - one of the few emulators
  78. that is substantially  FASTER  than the real thing, even on an old Amiga 500!
  79. Psion generously allows  free distribution of Qdos XCHANGE for 68000 systems,
  80. so it can be bundled with the emulator (currently at version 3.23 - beware of
  81. older ones which are buggy and not AGA compatible). Make sure you get the set
  82. of three disks (or archives); one is the Amiga startup disk, one contains the
  83. full source code, and the third is a Qdos disk holding XCHANGE and utilities.
  84.  
  85.  
  86. CREDITS
  87.  
  88. The original program  was written and tested in  QL SuperBASIC (on his Amiga)
  89. by Mark J Swift.  Version 1.014 is derived from Qdos version 1.01,  converted
  90. to run under Amigados and extended  by Simon N Goodwin.  The inner details of
  91. the  file formats were worked out by Chas Dillon, who also contributed the PC
  92. ASCII to ANSI conversion table.  Testing by Mark J Swift and Simon N Goodwin.
  93.  
  94.  
  95. EXTENSIONS
  96.  
  97. This version has been extended to support the PC version of Quill (sold as PC
  98. FOUR and PC XCHANGE) as well as the original QL/Thor/OPD versions. It detects
  99. the difference between the two types of _DOC file automatically. The PC files
  100. support italics as well as underlining, bold, superscripts and subscripts. In
  101. other respects DOC files are handled identically, although there are internal
  102. differences (for instance, PC files lack some Qdos screen colour options, and
  103. store internal numbers the other way round - in little rather than big endian
  104. order). Examine the HiSoft BASIC source if the differences interest you.
  105.  
  106. The program also converts character codes from Qdos ASCII or Msdos ASCII into
  107. ANSI, which suits the Amiga and PC clones running Windoze.  This is necessary
  108. because the codes for  accented and other  special characters  differ between
  109. systems.  If characters cannot be translated  (for instance, the  Qdos  arrow
  110. characters, codes 188 to 191,  which do not appear in the ANSI set,  they are
  111. replaced with a question mark.
  112.  
  113. The QL ASCII characters that cannot be translated to ANSI are: oe/OE ellipsis
  114. QL codes 139, 171), the greek letters  Alpha, Theta, Lambda, Pi and Phi (172,
  115. 174, 175, 177, 178),  Backward S (181)  and the arrows  (188, 189, 190, 191).
  116.  
  117. The MSDOS ASCII translation is not as complete,  but does include the accents
  118. used in French, Spanish and German, and the Beta character (German double S).
  119.  
  120.  
  121. Simon N Goodwin, simon@studio.woden.com, May 20th 1996.
  122.